2.4 Configuring the server settings

The server settings are derived from the value you provided for the MyID Server URL in the MyID installation program, and are initially stored in the appsettings.json file. If you need to change these settings, you can edit the appsettings.Production.json file to override the settings in the appsettings.json file.

Note: If you subsequently install or upgrade MyID again and provide a different value in the MyID Server URL in the MyID installation program, and you have set the Origin or ServerDomain options in the appsettings.Production.json file, the values you enter in the installation program are ignored; the appsettings.Production.json file is never updated by the installation program, and always takes precedence over the appsettings.json file.

To configure the server settings:

  1. As an administrator, open the appsettings.Production.json file in a text editor.

    By default, this is:

    C:\Program Files\Intercede\MyID\web.oauth2\appsettings.Production.json

    This file is the override configuration file for the appsettings.json file for the web service. If this file does not already exist, you must create it in the same folder as the appsettings.json file.

  2. Edit the file to include the following:

    Copy 
    {
        "Fido":{
            "Config":{
                "Origin":"https://<server>:<port>",
                "ServerDomain":"<server>"
            }
        }
    }

    where:

    • <server> – the name of the server to which users will authenticate.

    • <port> – optionally, the port to which users will authenticate, if you are using a non-standard HTTPS port.

    You must add the Origin and ServerDomain to any existing entries in the Fido:Config section. Your appsettings.Production.json file may already contain commented-out entries for these values; remove the double-slash // to uncomment the entries.

    Important: The Origin and ServerDomain options are case sensitive, and must be consistent with the casing of the DNS Name in the web server's TLS certificate.

    For example:

    Copy 
    {
        "Fido":{
            "Config":{
                "Origin": "https://myserver.example.com:30443",
                "ServerDomain": "myserver.example.com"
            }
        }
    }
  3. Save the appsettings.Production.json file.

  4. Recycle the web service app pool:

    1. On the MyID web server, in Internet Information Services (IIS) Manager, select Application Pools.
    2. Right-click the myid.web.oauth2.pool application pool, then from the pop-up menu click Recycle.

    This ensures that the web service has picked up the changes to the configuration file.